<html>
  <head>
    <meta http-equiv="content-type" content="text/html;charset=utf-8" />
    <title>WebBuilder 说明</title>
    <style type="text/css">
      hr{border:none;border-top:1px solid #bbbbbb;}
      .wb_code {background-color:#f7f7f7;border:solid 1px #e8e8e8;color:#314e64;font-size:12px;padding:5px;margin:5px 0 5px 0;line-height:1.6;}
    </style>
  </head>
  <body>
    <div style="padding:8px;line-height:20px;font-size:12px;font-family:tahoma,arial,verdana,sans-serif;">
      <h2>WebBuilder 说明</h2>
      <p>本文件的目的在于使您快速了解WebBuilder，以及如何安装WebBuilder到您的系统中。</p>
      <p>更多详情请访问：<a href="http://www.geejing.com" target="_blank">http://www.geejing.com</a>
      <hr>
      <h3>软件包目录和文件清单</h3>
      <ul>
        <li>misc：一些常用的供配置应用服务器时作参考的文件。</li>
        <li>wb：WebBuilder应用目录，可把此目录直接复制到web应用服务器应用目录。</li>
        <li>license.html：WebBuilder及其第三方软件授权协议。</li>
        <li>readme.html：本文件，用于对本软件包进行说明。</li>
      </ul>
      <hr>
      <h3>运行环境和系统安装</h3>
      <p>WebBuilder是一款很通用的平台，支持大多数运行环境，包括但不限于：</p>
      <ul>
        <li>操作系统：Linux，Unix，Windows，Mac等</li>
        <li>JDK环境：<span style="color:red">Java 8及以上版本（如果使用OpenJDK，需要下载Nashorn包。）</span></li>
        <li>Web Server/App Server：Apache Tomcat，Jetty，Resin，WebLogic，WebSphere等所有符合工业标准的服务器</li>
        <li>数据库：Sql Server，MySql，Oracle，Db2，Sybase等所有符合工业标准的数据库</li>
        <li>浏览器：Chrome，IE，Firefox，Opera，Safari以及其他基于这些内核的浏览器</li>
        <li>移动设备：Android，iOS，Windows Phone</li>
      </ul>
      <p>通常情况下，只需复制WebBuilder应用目录至目标服务器即可完成安装。使用安装向导的目的是进行数据库表的创建和复制。</p>
      <p>安装的主要工作是配置应用服务器的JNDI，关于JNDI的配置可以参考网上的相关文档和资料。</p>
      <p>以Tomcat8和Sql Server为例，安装步骤如下（其他运行环境部署步骤可参照此进行）：</p>
      <ol>
        <li>安装运行环境：包括Java 8、Tomcat 8和Sql Server。</li>
        <li>解压缩软件包webbuilder.zip，并把软件包根目录内的wb目录复制到tomcat8/webapps。</li>
        <li>在tomcat8/webapps/wb目录下创建META-INF目录，并在META-INF目录下创建context.xml文件以配置JNDI。<br>context.xml文件内容如下：</li>
        <div class="wb_code"><code>
          &lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>
          &lt;!DOCTYPE Context&gt;<br>
          &lt;Context reloadable="true" crossContext="true"&gt;<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&lt;WatchedResource&gt;WEB-INF/web.xml&lt;/WatchedResource&gt;<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&lt;Resource<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name="jdbc/wb_sqlserver"<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;auth="Container" type="javax.sql.DataSource"<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;validationQuery="select 1" testWhileIdle="true" testOnBorrow="false"<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span style="color:red">url="jdbc:sqlserver://127.0.0.1:1433;DatabaseName=wb"<br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;username="sa" password="111111"</span><br>
          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;maxActive="20" maxIdle="10" maxWait="-1" /&gt;<br>
          &lt;/Context&gt;
          </code></div>
        <p>其中，标记为红色字体部分需要根据目标数据库的实际情况，作相应的更改，<span style="color:red">指定名称的数据库必须已经存在</span>。在软件包中misc目录下有context.xml文件可作jndi配置参考。</p>
        <li>下载SQL Server驱动jar包 <a href="http://www.geejing.com/resource/sqljdbc4.jar" target="_blank">sqljdbc4.jar</a>，并复制该文件至tomcat8/lib目录，如有必要重启tomcat。</li>
        <li>打开浏览器（开发阶段建议使用Chrome）并访问 http://ip:port/wb/setup （例如http://localhost:8080/wb/setup），然后使用安装向导来完成 WebBuilder 的安装。</li>
        <p>在安装向导中，输入默认数据库JNDI和类型：</p>
        <div class="wb_code"><code>
          JNDI：java:comp/env/jdbc/wb_sqlserver<br>
          类型：sqlserver
          </code></div>
        <p>输入完成之后点击下一步，直到系统自动完成安装。</p>
        <li>安装完成之后，使用管理员帐户登录到系统，默认首页地址为 http://ip:port/wb/index，管理员默认用户名称和密码都为admin。</li>
        <li>优化Tomcat：可根据目标系统实际情况配置和优化连接池和线程池。</li>
      </ol>
      <p>在安装过程中如果发生错误，请尝试按下列方法来解决：</p>
      <ul>
        <li><span style="color:red">使用的Java版本是否为Java 8及以上版本。</span></li>
        <li>检查创建的默认数据库是否支持中文或utf-8编码。</li>
        <li>检查Java和Tomcat的版本是否匹配，比如Java 8应该使用Tomcat 8。</li>
        <li>检查tomcat8/conf/Catalina/localhost/wb.xml中的内容是否同jndi配置文件context.xml同步（wb.xml文件名同应用目录名）。</li>
        <li>如果安装提示duplicate entry异常，请确认数据库是否设置支持utf-8或gbk编码。</li>
        <li>检查数据库驱动jar包是否同数据库版本匹配。</li>
        <li>如发生异常NullPointerException，请检查JRE是否支持服务器端JavaScript（Nashorn）。</li>
        <li>如仍未能排除异常，请尝试把软件包中misc目录下test-jndi.jsp复制到应用目录wb下并修改相关代码，然后运行以测试jndi有效性。</li>
      </ul>
      <hr>
      <h3>相关链接和资源</h3>
      <ul>
        <li>WebBuilder 课堂：<a href="http://www.geejing.com/school" target="_blank">http://www.geejing.com/school</a></li>
        <li>WebBuilder 文档：<a href="http://www.geejing.com/wdocs" target="_blank">http://www.geejing.com/wdocs</a></li>
        <li>WebBuilder 相关资源下载：<a href="http://www.geejing.com/download.html" target="_blank">http://www.geejing.com/download.html</a></li>
        <li>官方网站：<a href="http://www.geejing.com" target="_blank">http://www.geejing.com</a></li>
        <li>联系我们：<a href="mailto:contact@geejing.com">contact@geejing.com</a></li>
      </ul>
    </div>
  </body>
</html>